home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 005 / multreg.arc / MULTREG.DOC < prev   
Text File  |  1987-02-09  |  12KB  |  268 lines
  1.  
  2.                   T U R B O   R E G R E S S I O N
  3.  
  4.  
  5.                       M U L T R E G . C O M
  6.                       ---------------------
  7.  
  8.  
  9. MULTREG.COM is a public domain program written by :
  10.  
  11.     L. R. Holliday
  12.     Vista Chemical Company
  13.     P. O. Box 500
  14.     Ponca City, Okla.  74602
  15.     (405) 767-6326
  16.  
  17. Copies of this program are not to be sold for profit. The program may be
  18. copied freely. USERS assume all risks when using this program.
  19.  
  20. MULTREG.COM is an interactive linear multiple regression program for the
  21. IBM PC. It runs under DOS Version 2.0 or higher. The program performs
  22. calculations similar to the MICROSTAT linear multiple regression program,
  23. but does not include all of the options and capabilities of MICROSTAT. The
  24. program is a modified version of a purchased program -- Turbo Regression
  25. Plus. The licensing agreement allows me to distribute copies of the
  26. compiled version of the program, but not the source code. If any problems
  27. are encountered in using the program, please contact the above.
  28.  
  29. MULTREG can handle up to 100 data points, and can read in values for up to
  30. 10 variables for each data point. The last variable read in is always the
  31. dependent variable, and there can be up to 9 independent variables. These
  32. limitations are due to the size of an array within the program. The size of
  33. the array can be increased, if needed, but the program would have to be
  34. re-compiled. Alternate data sets can be chosen without exiting from the
  35. program, and the calculations can be repeated as many times as desired
  36. without exiting from the program.
  37.  
  38.  
  39. Data Input
  40. ----------
  41.  
  42. The program reads text (ASCII) data files. The first line of the data file
  43. must contain the names of the variables, separated from each other by at
  44. least one blank. The variable names may contain any alphabetic or numeric
  45. characters, except embedded blanks. Subsequent lines of the data set
  46. contain the actual data values, with the values separated from each other
  47. by at least one blank. Each line should contain the same number of values
  48. as the number of variable names in the first line. A blank line will be
  49. read as a line containing missing values, so blank lines are acceptable.
  50. Missing values are indicated by any line having fewer values than the
  51. number of variable names read from the first line. Lines containing too
  52. many values will also be excluded, on the assumption that the line contains
  53. a typing error. All values will be read as real values, so it is not
  54. necessary to enter decimal points for whole number values. However, the
  55. progam reads the data in free format, so decimal points MUST be entered for
  56. values having a fractional part. A zero value can be indicated by 0 or a
  57. decimal point.
  58.  
  59. A sample data file (MULTREG.DAT) is included with the program to
  60. illustrate the data file format.
  61.  
  62.  
  63. A text data file can be created using any text editing program, such as
  64. EDLIN or the Turbo Pascal compiler. The data must be in text form, with one
  65. line for each data point, and no line numbers. Each value must be separated
  66. from the previous value by at least one blank (several blanks are suggested
  67. to improve readability of the data file). Lotus 1-2-3 provides an
  68. especially useful means for creating a data set, especially if some of the
  69. independent variables are transformed forms ( logs, inverses, squares, etc.)
  70. of other independent variables. Once the data and variable names have
  71. been entered into a Lotus file, Lotus can be used to generate an
  72. unformatted .PRN file of the data.  PRN files are ASCII files. The .PRN
  73. file must be unformatted to prevent page breaks, borders and margins from
  74. being included in the data file.
  75.  
  76. Input to the program has been "bullet-proofed" to a great extent. However,
  77. the program can be made to abort by having erroneous data in the data file.
  78. For example, if the data set has an alphabetic character where the program
  79. is expecting a numeric value, the program will abort. Also, if the data set
  80. contains more than 10 variable values in any line, the program will abort.
  81.  
  82.  
  83. RUNNING TURBO REGRESSION.
  84.  
  85. Once you have prepared a data file you are ready to run Turbo Regression.
  86. From the DOS prompt, simply type MULTREG, and the program will begin
  87. execution. When the program begins you will see a menu screen that allows
  88. you several options. First, you can select the F levels for inclusion and
  89. deletion in the regression. Second, you can select an input file (or select
  90. a new input file, if one is already selected). Next you can select to send
  91. your output to the screen, to the printer or to a disk file.  If you select
  92. a disk file, you must enter a name for the file in the next space on the
  93. menu. Lastly, you can select to have a printed output of the variables
  94. being read into the regression. The menu screen is illustrated below. The
  95. user does not have to enter a response to any of these prompts, if the
  96. default value is acceptable.
  97.  
  98.  
  99.                T U R B O    R E G R E S S I O N
  100.  
  101.  
  102.          F Level for Inclusion:              3.0
  103.  
  104.          F Level for Deletion:               3.0
  105.  
  106.          Name of Data File:                  ░░░░░░░░░░░░░░░
  107.  
  108.          Output to P)rinter, S)creen, F)ile: S
  109.  
  110.          Name of Output File:
  111.  
  112.          Print List of Observations (Y/N)?   N
  113.  
  114.  
  115.                   Press F10 to Continue...
  116.  
  117.  
  118. When you have answered the prompts appropriately, press the F10 key and
  119. Turbo Regression begins. If you made any mistakes in answering the prompts,
  120. the program will not leave the options menu. If your output is to the
  121. screen, you can move from screen to screen by pressing the return key. If
  122. you want to scroll the information on a screen, use the cursor control keys
  123. on the numeric pad. You can end the program at almost any time by pressing
  124. Esc.
  125.  
  126. When Turbo Regression begins, a screen display will be provided to alert
  127. the user to the progress of reading the data file. This display is
  128. illustrated below.
  129.  
  130.                            Reading File  x:filename.ext   . . . . .
  131.  
  132.  
  133.                            Number of Variables:     XX
  134.  
  135.  
  136.                            Cases Read:              XX
  137.  
  138.                            Cases Included:          XX
  139.  
  140.  
  141.                    ERROR -- LINE CONTAINED TOO FEW VARIABLES
  142.  
  143.                    ERROR -- LINE CONTAINED TOO MANY VARIABLES
  144.  
  145. Note that the two error messages will only appear if these errors occur in
  146. reading the data file. When the data file has been successfully read, a
  147. prompt will appear at the bottom of the screen display shown above:
  148.  
  149.               DO YOU WANT TO LIST THE DATA ON THE SCREEN (Y/N) ?
  150.  
  151. Answering Y to this prompt will cause all of the data read to be displayed
  152. on the screen, one screenful at a time. Answering N (or carriage return)
  153. will cause the program to go on to the next display. The user can select
  154. printer output of the data read in, screen display, or both.
  155.  
  156. If you selected to print the list of data, the screen will blank and the
  157. following message will be displayed:
  158.  
  159.            PRINTING LIST OF OBSERVATIONS . . . . . .
  160.  
  161. The list of observations will be be printed in draft mode if there were six
  162. variables or less. If there were more than six variables, the list will be
  163. printed in condensed print mode (if your printer uses the same control
  164. codes as an Epson printer). After printing the list, the printer will be
  165. returned to draft mode.
  166.  
  167.  
  168. The next display is a display of general information -- a review of the
  169. selections made by the user and the data read in. This display is
  170. illustrated below.
  171.  
  172.                    S T E P W I S E    R E G R E S S I O N
  173.                    --------------------------------------
  174.  
  175.                        Number of observations:   XX
  176.  
  177.                        Number of variables:      XX
  178.  
  179.                        Dependent variable is:    var_name
  180.  
  181.                        Data File is:             filename.ext
  182.  
  183.                        Cases Read:               XX
  184.  
  185.                        Cases Included:           XX
  186.  
  187.                        F-to-Include:             XX.XXXX
  188.  
  189.                        F-to-Exclude:             XX.XXXX
  190.  
  191.  
  192.                          Press RETURN to continue...
  193.  
  194. If printer output was selected in the entry menu, the screen will blank,
  195. the display shown above will be printed, and the following message will be
  196. displayed:
  197.  
  198.            PRINTING GENERAL INFORMATION . . . . . . . 
  199.  
  200. The next display is a display of summary statistics. This display is
  201. illustrated below.
  202.  
  203.                         S U M M A R Y    S T A T I S T I C S
  204.                         ------------------------------------
  205.  
  206.  
  207.                                                            Correlation with
  208. Variable           Arithmetic Mean     Std. Deviation        Ind_variable
  209. --------          -----------------   -----------------   -------------------
  210.  
  211. Var1                  xx.xxxxxx           xx.xxxxxx            x.xxxxxx
  212. Var2                  xx.xxxxxx           xx.xxxxxx            x.xxxxxx
  213. Var3                  xx.xxxxxx           xx.xxxxxx            x.xxxxxx
  214.   |
  215.   |
  216.   |
  217.  
  218.  
  219.            Use Keypad to Scroll - Return to Continue - Esc to Quit
  220.  
  221. If the summary statistics display is longer than one screenful (not
  222. likely), the cursor keys can be used to review the display.
  223.  
  224.  
  225. If printer output was selected in the entry menu, the screen will blank,
  226. the display shown above will be printed, and the following message will be
  227. displayed:
  228.  
  229.            PRINTING SUMMARY STATISTICS . . . . . . . 
  230.  
  231. Following the summary statistics display, the screen will blank and the
  232. following prompt will be displayed:
  233.  
  234.            DO YOU WANT TO DISPLAY THE CORRELATION MATRIX (Y/N) ?
  235.  
  236. If you answer Y, the correlation matrix will be displayed on the screen (or
  237. printed on the printer if printer output was selected). This display will
  238. usually be longer than one screenful, but all of the display can be viewed
  239. by using the cursor keys. If you answer N (or carriage return), both the
  240. screen display and the printout of the correlation matrix will be skipped.
  241.  
  242. If you answer Y to the correlation matrix prompt, and printer output was
  243. selected in the entry menu, the screen will blank, the correlation matrix
  244. display will be printed, and the following message will be displayed:
  245.  
  246.            PRINTING CORRELATION MATRIX . . . . . . . 
  247.  
  248. The final display is a display of regression steps. Each step of the
  249. stepwise regression occupies one screen. If the information exceeds the
  250. screen size, the cursor keys can be used to view the whole display. The
  251. program will not move on to the next step until you press RETURN (unless
  252. printer output was selected). If printer output was selected, the program
  253. prints all of the regression steps while displaying the following message:
  254.  
  255.            PRINTING REGRESSION ANALYSIS RESULTS . . . .
  256.  
  257. When the program completes the regression analysis, it returns to the entry
  258. menu, with the name of the input file just processed displayed on the Name
  259. of Data File line. If you want to process the same file again, with
  260. different parameters (changed F test values, or printer output on, for
  261. example) then make the appropriate changes on the appropriate lines, and
  262. then press F10. If you want to process a different data file, move the
  263. cursor to the Name of Data File line, enter the new data file name, make
  264. any other changes desired, and then press F10. If you want to exit from the
  265. program, press Esc.
  266. hese errors occur in
  267. reading the data file. When the data file has been successfully read, a
  268. prompt will a